home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / at.man < prev    next >
Encoding:
Text File  |  1989-04-06  |  3.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. AT                        User Commands                        AT
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      at - execute commands at a later time
  10.  
  11. SSYYNNOOPPSSIISS
  12.      aatt [[ --cc ]] [[ --ss ]] [[ --mm ]] time [ day ] [ file ]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      _A_t spools away a copy of the named _f_i_l_e to be used as input
  16.      to _s_h(1) or _c_s_h(1).  If the --cc flag (for (_c_s_h(1))) or the --ss
  17.      flag (for (_s_h(1))) is specified, then that shell will be
  18.      used to execute the job; if no shell is specified, the
  19.      current environment shell is used.  If no file name is
  20.      specified, _a_t prompts for commands from standard input until
  21.      a ^D is typed.
  22.  
  23.      If the --mm flag is specified, mail will be sent to the user
  24.      after the job has been run. If errors occur during execution
  25.      of the job, then a copy of the error diagnostics will be
  26.      sent to the user. If no errors occur, then a short message
  27.      is sent informing the user that no errors occurred.
  28.  
  29.      The format of the spool file is as follows: A four line
  30.      header that includes the owner of the job, the name of the
  31.      job, the shell used to run the job, and whether mail will be
  32.      set after the job is executed. The header is followed by a
  33.      _c_d command to the current directory and a _u_m_a_s_k command to
  34.      set the modes on any files created by the job.  Then _a_t
  35.      copies all relevant environment variables to the spool file.
  36.      When the script is run, it uses the user and group ID of the
  37.      creator of the spool file.
  38.  
  39.      The _t_i_m_e is 1 to 4 digits, with an optional following `A',
  40.      `P', `N' or `M' for AM, PM, noon or midnight.  One and two
  41.      digit numbers are taken to be hours, three and four digits
  42.      to be hours and minutes.  If no letters follow the digits, a
  43.      24 hour clock time is understood.
  44.  
  45.      The optional _d_a_y is either (1) a month name followed by a
  46.      day number, or (2) a day of the week; if the word `week'
  47.      follows, invocation is moved seven days further off.  Names
  48.      of months and days may be recognizably truncated.  Examples
  49.      of legitimate commands are
  50.  
  51.           at 8am jan 24
  52.           at -c -m 1530 fr week
  53.           at -s -m 1200n week
  54.  
  55.      _A_t programs are executed by periodic execution of the com-
  56.      mand  /usr/lib/atrun from _c_r_o_n(8).  The granularity of _a_t
  57.      depends upon the how often atrun is executed.
  58.  
  59.      Error output is lost unless redirected or the -_m flag is
  60.  
  61.  
  62.  
  63. Sprite v1.0              March 20, 1986                         1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AT                        User Commands                        AT
  71.  
  72.  
  73.  
  74.      requested, in which case a copy of the errors is sent to the
  75.      user via _m_a_i_l(1).
  76.  
  77. FFIILLEESS
  78.      /usr/spool/at                spooling area
  79.      /usr/spool/at/yy.ddd.hhhh.*  job file
  80.      /usr/spool/at/past           directory where jobs are executed from
  81.      /usr/spool/at/lasttimedone   last time atrun was run
  82.      /usr/lib/atrun               executor (run by cron(8))
  83.  
  84. SSEEEE AALLSSOO
  85.      atq(1), atrm(1), calendar(1), sleep(1), cron(8)
  86.  
  87. DDIIAAGGNNOOSSTTIICCSS
  88.      Complains about various syntax errors and times out of
  89.      range.
  90.  
  91. BBUUGGSS
  92.      Due to the granularity of the execution of /_u_s_r/_l_i_b/_a_t_r_u_n,
  93.      there may be bugs in scheduling things almost exactly 24
  94.      hours into the future.
  95.  
  96.      If the system crashes, mail is not sent to the user inform-
  97.      ing them that the job was not completed.
  98.  
  99.      Sometimes old spool files are not removed from the directory
  100.      /usr/spool/at/past. This is usually due to a system crash,
  101.      and requires that they be removed by hand.
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0              March 20, 1986                         2
  130.  
  131.  
  132.  
  133.